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PREFACE 



This manual describes operating procedures for the ISIS-II 8080/8085 Macro 
Assembler. The assembler translates 8080/8085 assembly language source code into 
object code executable on the 8080/8085 microprocessors. No discussion of 
assembly language or assembler directives is provided here, as these topics are 
covered in the document 

8080/8085 Assembly Language Programming Manual 9800301 

The ISIS-II assembler is invoked using the diskette operating system facility of 
Intel's Intellec Microcomputer Development System. Use of this facility is described 
in the document 

ISIS-II System User's Guide 9800306 
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CHAPTER 1 
ASSEMBLER OVERVIEW 



An assembler performs the clerical function of converting your assembly language 
program into machine-executable form. It accepts your source file and, depending 
on the output options selected, can produce an executable object file, a listing of the 
source and assembled code, and a symbol cross-reference listing. 



The ISIS-II 8080/8085 Macro Assembler (ASM80) runs under the Intel Systems Im- 
plementation Supervisor (ISIS-II) and resides on the ISIS-II system diskette. Opera- 
tion of the ISIS-II assember is the subject of this manual. 



Details for loading and controlling the ISIS-II assembler are given in Chapters 2 and 
3. List formats are shown in Chapter 4. Error messages issued by the assembler are 
listed in Chapter 7. Chapter 5 describes the linkage conventions for passing 
parameters from an assembly language program module to a PL/M module. The 
hardware/software environment requirements are summarized below. 



ISIS-II Assembler Environment 

The ISIS-II assembler uses the following hardware: 

• Intellec system with 32K RAM memory (48K if source contains macros) 

• Console device (TTY or CRT) 

• Diskette unit 

• Line printer (if available) 

This assembler runs under ISIS-II, which includes the Locater, Linker, and Library 
Manager. 



Overlay and Nonoverlay Operating Modes 

The ISIS-II assembler can be run in either an overlay or nonoverlay mode. Overlay 
mode requires only 32K of Intellec memory and is selected by specifying the 
NOMACROFILE control (described in Chapter 2). This control can be specified 
only if your program does not include macros. 



If your program has macros, or if you want faster assemblies, specify the 
MACROFILE control. Your Intellec system must have a 48K memory in this case, 
but the assembler can run in nonoverlay mode. Specifying MACROFILE also adds 
the macro reserved symbols (MACRO, ENDM, LOCAL, REPT, IRP, IRPC, 
EXITM) to the list of reserved words. 



No matter how much Intellec memory you have, the assembler runs in overlay 
(slower) mode unless you specify MACROFILE. (NOMACROFILE is the default 
control.) Both modes use an optional overlay to create cross-reference listings. 
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Symbol Table Size 

In overlay mode with 32K of Intellec memory, you can generate slightly more than 
200 symbols. In nonoverlay mode with 48K of memory, you can have slightly more 
than 800 symbols. Each 16K memory increment adds 2000 symbols. 

Macro processing uses a small amount of memory (for storing actual parameters) 
that could otherwise be used for symbols. The size or number of macro definitions 
does not affect symbol table space, however, since macro definitions are stored in a 
diskette file. 

If you need more symbol table space, you can either add more Intellec memory or 
divide your program into smaller modules. 



Input/Output Files 
Source File 

The input to the ISIS-II assembler is a source file, which can contain three elements: 

• An 8080/8085 assembly language program, composed of instructions described 
in the 8080/8085 Assembly Language Programming Manual (9800301); 

• Assembler directives, described in the same manual; 

• Assembler control lines, described in the next chapter of this manual. 

Only the instructions in your assembly language program are translated into exe- 
cutable object code. 

Object File 

The ISIS-II assembler creates its object file on a flexible diskette. 

The object file contains machine language instructions and data that can be loaded 
into memory for execution or interpretation. In addition, it contains control in- 
formation governing the loading process (such as the starting address for program 
execution). 

The assembler can produce object files in relocatable object code format. The object 
modules produced by the ISIS-II 8080/8085 assembler can be loaded and executed 
anywhere in memory if they don't interfere with other programs they need ^or pro- 
per operation. The modules can also be linked to form a larger program. See the 
ISIS-II Systems User's Guide (9800306) for details. 



List File 

The list file is a formatted file designed to be output to a line printer or terminal. It 
includes listings of: 

• Your assembled object code; 

• Your source program; 

• A table of symbols and their values; 

• A summary of assembly errors . 

The formats of these listings are described in Chapter 4. 
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Symbol-Cross-Reference File 

During the first pass of the assembler, a file of symbol-cross-reference records is 
created, if requested. This diskette file is named ASXREF.TMP. 

In general, the assembler generates two types of symbol-cross-reference records: 
symbol-definition records and symbol-reference records. If a symbol appears as a 
name in a label field and the symbol is being defined (by SET, EQU, MACRO, or as 
a label), a symbol-definition record is produced. If the symbol is being redefined by 
SET or MACRO, it is considered a symbol definition. All other symbol occurrences 
are considered references and cause the assembler to generate a symbol-reference 
record each time the symbol appears. Symbol definition records are terminated by a 
pound sign (#) in the cross-reference listing. 

All symbols are cross referenced except dummy parameters and local labels appear- 
ing in macro definitions (that is, all global user-defined symbols, macro names, and 
actual symbols replacing dummy parameters or local labels are cross referenced). 
When certain controls that suppress source listmg are specified (NOLIST, NOGEN, 
NOCOND), symbols not listed are not cross referenced. 

The assembler calls on ISIS-II to load its cross-reference-generator program and 
ASXREF.TMP from the diskette. From the programmer's point of view, the opera- 
tions required to produce the cross-reference listing are automatic (once the cross 
reference file has been requested). The format of the cross-reference listing is shown 
in Chapter 4. 

Assembler Files 

The ISIS-II assembler uses several files of its own, such as the intermediate cross- 
reference file just mentioned. While you don't need to remember the names of these 
files, you must know where they reside to avoid diskette space conflict. 

The assembler root program (ASM80) and its overlays (ASMSO.OVn, where 
n=0,l,2...) must reside on the same diskette, but this diskette can be on any drive. 
The cross-reference generator (ASXREF) must reside on this diskette also. 

The intermediate cross-reference file (ASXREF.TMP) is written to the drive con- 
taining your source file. The MACROFILE control determines where the in- 
termediate macro file (ASMAC.TMP) is written; the default is the source file drive. 

The list and object files can be directed to any drive via assembler controls. The 
default sends these files to the source file drive. 
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CHAPTER 2 
ASSEMBLER CONTROLS 



Introduction to Assembler Controls 

Assembler controls allow you to specify the input/output files or devices to be used 
by the assembler and whether list or object files (or portions of these files) are to be 
generated by the assembler. Controls can be specified at two levels: 

• In commands specified at assembly time 

• As control lines embedded throughout your source file 

The latter allows selective control over sections of your program. For example, you 
might want to suppress the assembly listing for certain sections of your program, or 
to cause page ejects at specific places. 

Primary and General Controls 

Controls are classified as primary and general. Both classes of controls can be set 
when the assembler is run or in source file control lines. However, source file control 
lines containing primary controls must be inserted before the first line of comments 
or source code. General controls can be respecified at any time. 

The ISIS-II assembler allows primary controls to be specified only once. This applies 
to controls specified in assembly-time command lines, to control lines embedded in 
your source code, or combinations of the two. 



Specifying Controls 

Controls can be specified using either upper-case or lower-case characters. 

If a control is specified incorrectly in an assembly-time command, the entire com- 
mand is ignored and must be reentered. 

If a control is specified incorrectly in a source code control line, the incorrect control 
and all controls following it in the line are ignored. 

Summary of Controls 

The following list shows the controls available, their basic functions, and whether 
they are primary or general (P/G). Default controls elk italicized. The remainder of 
this chapter describes each control in greater detail. 



Control 


P/G 


Function Area 


OBJECT INOOBJECT 


P 


Object File 


DEBUG INODEBUG 


P 


Object File 


P/?//Vr/NOPRINT 


P 


Assembly Listing 


CONDIUOCOHD 


G 


Assembly Listing 


USTIHOUSJ 


G 


Assembly Listing 


SYMBOLS mOSYMBQLS 


P 


Assembly Listing 


mEflNOXREF 


P 


Cross-Reference Listing 


PAGING IHOPkQmGi 


P 


Listing Format 
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Control 


P/G 


Function Area 


PAGELENGTH {66) 


P 


Listing Format 


PAGEWIDTH {120) 


P 


Listing Format 


TITLE 


G 


Listing Format 


EJECT 


G 


Listing Format 


GE/V /NOGEN 


G 


Macro List 


MACRODEBUG INOMACRODEBUG 


P 


Macro List 


M ACROFILE INOMACRORLE 


P 


Macro Temporary File 


MOD85 


P 


8085 Switch 


SAVE 


G 


Stacl( Controls 


RESTORE 


G 


Fetch Controls 


INCLUDE 


G 


Library Function 


TPflNOTTY 


P 


Teletypewriter Function 



In general, controls go into effect at the end of the control line. Exceptions occur for 
control lines that cause a transition between 'listing' and 'not listing' states. 

If the transition is caused by a change in the LIST/NOLIST controls, the control 
line containing the LIST/NOLIST is always printed. If a change in GEN/NOGEN 
causes the transition, the control line is not printed. If the control line contains both 
LIST/NOLIST and GEN/NOGEN changes, the control hne is printed. 



ISIS-II Assembler Controls 
ISIS-II Assembly-Time Command 

The ISIS-II Assembler for the 8080 or 8085 is invoked by calling the ISIS-II file 
ASM80. This call includes the name of your source file and any assembler controls 
you wish to specify. Items in the control list are separated by spaces. The call is 
terminated by a carriage return. 



-ASM80 file control-list 



The "file" in this format is your source file. This file (and files enclosed in paren- 
theses as part of a control) can be a 1-6 character file name, a file name followed by 
a period and 1-3 character extension, an ISIS-II device name, or an ISIS-II device 
name followed by a file name and extension. (See the ISIS-II System User's 
Guide for details.) 



Examples: 

FILE20 
PROG.SRC 

■ up- 

:F1:ASSMB.SRC 



(filename) 

(filename. extension) 
(:ISIS-II device name.) 
(:ISIS-II dev name:fiiename.ext) 



All control items specified must be spelled out in their entirety. 

Example: 

-ASM80 PROG.SRC DEBUG SYMBOLS XREF 
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Primary Controls 
Control 

OBJECT(flle) 



NOOBJECT 
MOD85 



DEBUG 

NODEBUG 
PRINT(file) 



NOPRINT 

SYMBOLS 

NOSYMBOLS 

XREF 

NOXREF 
MACROFILE(drive) 



NOMACROFILE 



PAGELENGTH(n) 



PAGEWIDTH(n) 



Effect 



An object code file is generated and is output to the 
specified diskette file. If this control is omitted, 
"OBJECT(file.OBJ)" is assumed, where "file" is the 
name of your source file; the file is directed to the same 
drive used for the source file. 

Object code generation is suppressed. 

The assembler assumes that 8080 code is being 
assembled unless the 8085 instruction set is specified by 
this control. This assembler issues a warning if an 8085 in- 
struction is encountered in the 8080 mode. 

If an object file is requested, the symbol table is output to 
that file. DEBUG has no effect otherwise. 

The symbol table is not Included in the object file. 

An assembly list file is generated and is output to the 
specified file. If this control is omitted, "PRINT(file.LST)" 
is assumed, where "file" is the name of your source code 
file; the file is directed to the name drive used for the 
source file. See general control LIST. 

The assembly output listing is suppressed. No file 
is specified for listing; therefore, no listing output is 
possible. 

If a list file is opened by PRINT, the symbol table is output 
to the list file. SYMBOLS has no effect otherwise. 

The symbol table is not included in the list file created by 
PRINT. 

A symbol-cross-reference file is requested. An 
intermediate file is output to ASXREF.TMP and the cross- 
reference listing to the file created by PRINT. 

Symbol-cross-reference file generation is suppressed. 

The macro definition file is directed to the specified drive. 
If no drive is specified, the drive where the source file 
resides is used. Your Intellec system must have a 48K 
memory if MACROFILE is specified as the assembler runs 
in nonoverlay mode. MACROFILE also adds the macro 
reserved words (MACRO, LOCAL, etc.) to the reserved 
word list. 

No macro temporary files are created. If your source file 
contains macros, all definitions and calls cause errors. 
This control lets the assembler run on a 32K-memory 
Intellec system in overlay mode. 

Each list file page is "n" lines long, where "n" must be at 
least 12 and includes 3 blank lines at the top of the page, 3 
blank lines at the bottom of the page, and any page 
headings specified. If "n" is <11, PAGELENGTH is set to 
12. The default value is 66. 

Note that 3 blank lines are issued to reach the next "top- 
of- page" as opposed to issuing form feeds to reach the 
physical "top-of-form." 

Each list file line can be up to "n" characters long, where 
"n" must be in the range 72<n<132. Lines exceeding the 
page width are continued in column 25 of the following line 
(but lines >132 characters are truncated to 132). The 
default page width is 120. 
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Control 

PAGING 

NOPAGING 

MACRODEBUG 

NOMACRODEBUG 

TTY 
NOTTY 



Effect 

The assembler separates listing into pages with headers 
at each page break. 

The listing is not separated into pages. Headers are 
printed only once at the beginning of the listing. 

Assembler-generated macro symbols are output to the list 
and object files when the symbol table is output. 

Assembler-generated macro symbols are not output to 
the list and object files. 

Simulates form-feed for teletypewriter output. 

No teletypewriter output (form-feed simulation). 



General Controls 
Control 

INCLUDE(file) 



LIST 

NOLIST 

COND 

NOCOND 

GEN 



Effect 

Subsequent source lines are input from a specified file 
until an end-of-file or nested INCLUDE is found. (Nesting 
may be four deep.) Following the end-of-file, input 
resumes from the file being processed when the IN- 
CLUDE was encountered. The primary use of INCLUDE is 
to provide a macro library capability. 

All include lines have an "=" printed in column 19. After 
the initial INCLUDE, any nested INCLUDES have their 
nesting level (1-4) printed in column 18. 

An assembly output listing is generated and sent to the 
file specified by the PRINT control. 

Assembly listing is suppressed, except tines containing 
errors. 

Conditionally-skipped source code is included in the 
assembly listing if LIST is selected. The conditional- 
assembly directives are also listed. 

Listing of conditionally-skipped source code and 
conditional-assembly directives is suppressed. Listing of 
the EXITM directive is suppressed also. 

Macro expansion source text generated by macro calls is 
listed if LIST is selected. 



NOGEN 
TITLECstring') 



EJECT 



SAVE 



RESTORE 



Macro expansion source text listing is suppressed. 

The specified string is printed in character positions 1-64 
of the second line of page headings. Strings longer than 
64 characters are truncated. 'String' must not be null. TI- 
TLE remains in effect until another TITLE is encountered. 
The assembler inserts a blank line if TITLE is not 
specified. 

Spaces are skipped to the next top-of-form. The position 
of the next top-of-form is determined by PAGELENGTH, 
not by the physical top-of-form. 

The current settings of the LIST, COND, and GEN controls 
are stacked (but remain valid until explicitly changed). 
These controls can be stacked up to eight levels deep. 

The LIST, COND, and GEN control settings at the top of 
the stack are restored. 
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Defaults 

The foUowing defaults are assumed by the ISIS-II assembler if the corresponding 
controls are not sdected: 

OBJECTdile.OBJ) 

NODEBUG 

PR»NT(file.LST) 

LIST 

SYMBOLS 

COND 

GEN 

NOXREF 

NOMAGRODEBUG 

NOMACROFILE 

PAGING 

PAGELENGTH(66) 

PAGEWIDTH(120) 

ISIS-II Assembler Control Lines 

The format for control lines embedded in source files to be processed by the ISIS-II 
assembler is 

$control list 

where **$" must appear in column 1 and items in the control list are separated by 
spaces. 

Example: 

$LIST DEBUG XREF MOD85 

Control lines containing primary controls must appear before the first statement in 
the source file, including comments. General control lines can be interspersed 
throughout the source file. 

A control line containing more than one control is scanned from left to right. If a 
control is specified incorrectly, it is ignored. All remaining controls on that line are 
also ignored. 
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CHAPTER 3 
ASSEMBLER OPERATION 



The ISIS-II 8080/8085 Assembler resides on the ISIS-II system diskette. The 
assembler is loaded by calling ASM80 at the ISIS-II command level and specifying 
your source file along with any desired assembler controls (Chapter 2). All requested 
assembler operations are performed without further intervention once the assembly 
begins. 

Activation Sequence 

The following command activates and completes an ISIS-II assembly: 

-ASM80 PROG.SRC SYMBOLS NODEBUG 

Following the ISIS-II command prompt (-), you issue a command to assemble the 
file PROG.SRC. Be default, an assembly listing and object code file are requested 
and are output to PROG.LST and PROG. OBJ respectively. In addition, a symbol 
table listing is performed, but symbol table output to the object file is suppressed. 
Note that the same effect can be achieved with no control specification, since the 
controls specified are both defaults. 

The assembler sends out its sign-on message to the console device: 

ISIS-II 8080/8085 MACRO ASSEMBLER, V2.0 
After execution, the assembler issues a sign-off message and error summary: 

ASSEMBLY COMPLETE, NO ERRORS 
If XREF is selected, the sign-on message 

ISIS-II ASSEMBLER SYMBOL CROSS REFERENCE, V2.0 
is then issued on the console. 

Sample Assembly 

The following example illustrates a typical use of the ISIS-II assembler. A short pro- 
gram (MBADD.SRC) is taken through all the steps needed to activate the assembler, 
obtain an object code file, and generate a symbol-cross-reference listing. The source 
program to be assembled is shown first, followed by the assembler activation se- 
quence. The resulting assembly and symbol-cross-reference listings are also shown. 

The source code for program MBADD.SRC is as follows: 



$ TITLECMULTIBYTE ADDITION PROGRAM') 

NAME MBADD 
LOAD MACRO 0PD1.0PD2.C0UNT 
L1: LXI B,0PD1 ;;ADDRESS0F1STN0.T0BC 

LXI H,0PD2 ;;ADDRESS0F2NDN0.T0HL 

LXI D.COUNT :;LOOP CONTROL COUNT TO D 

ENDM 

CSEO 

PUBLIC NUM1,NUM2,NUM3 

EXTRN MAIN 
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CBASE 


EQU 


0100H 






ORG 


CBASE 




START: 


LOAD 


NUM1.NUM2.NUM3 




XRA 


A 


CLEAR ACCUMULATOR 


LOOP: 


LDAX 


B 


LOAD BYTE OF 1ST NO. 




ADC 


M 


ADD BY lb OF 2ND NO. 




STAX 


B 


STORE RESULT 




DOR 


D 


DONE IF REG D = 




JZ 


MAIN 


RETURN TO MAIN PROGRAM 




INX 


B 


INCRBC TO NEXT BYTE 




INX 


H 


INCRHL TO NEXT BYTE 




JMP 


LOOP 


ADD NEXT TWO BYTES 


NUM1: 


DB 


090H 


1ST NUMBER 




DB 


OBAH 






DB 


084H 




NUM2: 


DB 


08AH 


2ND NUMBER 




DB 


OAFH 






DB 


032H 




NUM3: 


DB 


003H 






END 


START 





Once loaded, the ISIS-II assembler performs its operations without further user in- 
tervention. In this example, both assembly listing and object output are requested by 
default. The activation sequence is as follows: 

-ASMBO MBADD.SRC SYMBOLS XREF MACROFILE 

The source file is specified as MBADD.SRC. The PRINT control file defaults to 
MBADD.LST. The OBJECT control file defaults to MBADD.OBJ. A symbol- 
cross-reference listing is also requested and macros are present. 

The assembly and cross-reference listings are shown below. For a detailed explana- 
tion of each item in these listings, see Chapter 4. 



-ASM80 MADD.SRC SYMBOLS XREF MACROFILE 
ISIS-II 8080/8085 MACRO ASSEMBLER, V2.0 
MULTIBYTE ADDITION PROGRAM 



MBADD 



PAGE1 



LOC OBJ 



0100 
0100 

0100 011601 
0103 211901 
0106 111C01 
0109 AF 
100A OA 
01 OB 8E 
01 OC 02 
010D 15 
010E CAOOOO 

0111 03 

0112 23 

0113 C30A01 
0116 90 



LINE 

U 

2 

3LDAD 

4 LI: 

5 

6 

7 

8 

9 
10 

11 CBASE 
12 

13 START: 
14+ LI: 
15+ 
16+ 
17 

18 LOOP: 
19 
20 
21 
22 
23 
24 
25 
26NUM1: 



SOURCE STATEMENT 

TITLECMULTIBYTE ADDITION PROGRAM') 

NAME MBADD 

MACRO 0PD1.0PD2,C0UNT 



LXI B,0PD1 

LXI H,0PD2 

LXI D.COUNT 

ENDM 

CSEG 

PUBLIC NUM1,NUM2,NUM3 

EXTRN MAIN 

EQU 0100H 

ORG CBASE 

LDAD NUM1.NUM2,NUM3 

LXI B,NUM1 

LXI H,NUM2 

LXI D,NUM3 

XRA A 

LDAX B 

ADC M 

STAX B 

DCR D 

JZ MAIN 

INX B 

INX H 

JMP LOOP 

DB 090H 



;ADDRESS OF 1ST NO. TO BC 
;ADDRESS OF 2ND NO. TO HL 
;LOOP CONTROL COUNT TO D 



CLEAR ACCUMULATOR 
LOAD BYTE OF 1ST NO. 
ADD BYTE OF 2ND NO. 
STORE RESULT 
DONE IF REG D = 
RETURN TO MAIN PROGRAM 
INCRBC TO NEXT BYTE 
INCRHL TO NEXT BYTE 
ADD NEXT TWO BYTES 
1ST NUMBER 
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0117 BA 


27 


DB 


OBAH 




0118 84 


28 


DB 


084H 




0119 8A 


29 NUM2: 


DB 


OBAH 


;2ND NUMBER 


011A AF 


30 


DB 


OAFH 




011B 32 


31 


DB 


032H 




011C 03 


32 


NUM3: 


DB 


003H 


0100 


33 


END 


START 





PUBLIC SYMBOLS 

NUM1 C 0116 NUM2 C 0119 NUM3 C 011C 

EXTERNAL SYMBOLS 
MAIN E 0000 

USER SYMBOLS 

CBASE A 0100 LI A 0100 LOOP C 010A MAIN E 0000 

NUM1 C 0116 NUM2 C 0119 NUM3 C 011C START A 0100 

ASSEMBLY COMPLETE, NO ERRORS 

Note that the '^ASSEMBLY COMPLETE" message is also issued on the console, 
followed by the cross-reference sign-on message if a cross-reference listmg has been 
requested. 



ISIS-II ASSEMBLER SYMBOL CROSS REFERENCE, V2.0 
SYMBOL CROSS REFERENCE 



PAGE1 



CBASE 


11# 


12 






LI 


4« 








LOAD 


3# 


13 






LOOP 


18# 


25 






MAIN 


10 


22 






MBADD 


2 








NUM1 


9 


13 


14 


26* 


NUM2 


9 


13 


15 


29« 


NUM3 


9 


13 


16 


32« 


START 


13# 


33 







CROSS REFERENCE COMPLETE 
Control then returns to ISIS-II, which prompts for the next command with a hyphen 



Reducing Assembly Time 



In the program debugging stage of project development, you can save an assembly 
pass by specifying NOOBJECT. If you want an error coimt, specifying NOPRINT 
with NOOBJECT yields an error count on the console as the only output. If you 
want just a listing of the lines in error, specify NOLIST and NOSYMBOLS. 

Assembly time can be decreased by minimizing operations requiring a lot of diskette 
activity. INCLUDES always increase diskette activity. Control lines embedded in 
your source code cause increased overlay activity in overlay mode. Macro defini- 
tions are stored on a diskette; heavy use of macro calls and nested macro definitions 
cause increased diskette activity. 
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CHAPTER 4 
LIST FILE FORMATS 



Assembly Listing Format 

The assembly list file is designed for output to a line printer or terminal. Unless 
otherwise specified, an output page consists of 66 lines, 120 characters wide, and in- 
cludes three leading and three traiUng blank lines, a page header, title line, column 
headings, and assembly output lines. If a listing line exceeds the right margin setting, 
it is continued in column 25 of the following line (unless the line exceeds 132 
characters, in which case those >132 are truncated). 

The first line of the first page of a listing is an echo of the ISIS-II call to the 
assembler followed by the page header. 

If the NOP AGING assembler control is selected, the page header is followed by the 
title line and column headings, and finally the complete assembly listing with no ad- 
ditional headers. 

Page Header 

Columns Description 

1-33 The string "ISIS-II 8080/8085 MACRO ASSEMBLER" 

34 Blank. 

35-38 The string "Vx.y" where "x" is the version and "y" is the release number. 

39-46 Blanks. 

47-52 Program module name from the NAME directive. 

53-64 Blanks. 

65-68 The string "PAGE" 

69 Blank. 

70-72 Three character positions containing the page number in decimal. 



Title Line 

Columns Description 

1-64 Program title as specif led in TITLE assembler control. 



Column Heading 

Columns Description 

1-2 Blanks. 

3-5 The string "LOG" 

6-7 Blanks. 

8-10 The string "OBJ" 

11-16 Blanks. 

17-19 The string "SEQ" 

31-46 The string "SOURCE STATEMENT' 
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Assembly Output Line 

Columns Description 

1 Assembler error code. If the assembler encountered a syntax error in this 
source line, the appropriate error code appears in this column. Otherwise, 
this column is blank. If an error occurs in the present line, the following line 
will be blank except for a decimal sequence number In columns 3-6 en- 
ctosed by parentheses. This sequence number is a pointer to the previous 
line containing an error. The first error encountered in a program will be fol- 
lowed by a line with a pointer equal to zero. See Chapter 7 for error codes. 

2 Minus sign (-) Indicates macro definition; otherwise blank. 

3-6 The address assigned to the first byte of the object code shown in columns 

8-9 of thio line is printed in hexadecimal. In addition, the result of the value- 
generating assembler directives ORG, EQU, SET, and END will appear in 
this field. For END, the program start address value will appear in this field if 
specified; otherwise blank. 

7 Blank. 

8-9 The first byte of object code produced by the assembler for this source line 

is printed here in hexadecimal. If the source statement produces no object 
code (comments and assembler directives), this field is blank. 

10-11 Second byte of object code in hexadecimal. This field will be blank if the 

source statement generates only one byte of object code or no object code. 

12-13 Third byte of object code in hexadecimal, if generated; otherwise, blank. 

14-15 Fourth byte of object code in hexadecimal, if generated; otherwise, blank. 

16 Blank. 

17 Object code type. The reiocatability of an operand is determined by the 
segment in which the operand lies, not by the segment that references the 
operand. Values are as follows: 

C = CODE - segment relocatable 

D = DATA - segment relocatable 

S = STACK - segment relocatable 
M= MEMORY - segment relocatable 
E = EXTERNAL 

For a discussion of reiocatability, see the 8080/8085 Assembly Language 
Programming Manual. 

18 Blank if no nested source INCLUDE files; otherwise, the number 1-4 
indicating the level of nesting. 

19 Blank if not listing a source INCLUDE file; othenwise an "=" sign. 

20-23 Four character positions containing the source line number in decimal, 

right-justified and left blank-filled. 

24 Macro expansion flag. A " -i- " in this column indicates that the source line 

was produced as a result of a macro expansion. Otherwise, this column will 
be blank. 

25-... Listing of assembler source text. This field terminates at column 72 for most 

output devices other than the line printer. For a line printer, this field ter- 
minates at column 132. 



For DB and DW assembler directives containing a list of operands, the generated 
code for each operand is listed on a separate line. 

If a list line exceeds the specified page width, the source line continues starting at 
column 25 of the next line. 
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Symbol Table Listing 

The listing of the assembled source code is optionally followed by the symbol 
table listing. If the NOSYMBOLS control is specified, the symbol table listing is 
suppressed. 

The assembler lists the symbol table in three sections: PUBLIC symbols, EXTER- 
NAL symbols, and symbols defined by the user in the current assembly (including 
PUBLIC and EXTERNAL symbols). Each section of the symbol table is preceded 
by a title in columns 1-16 of the listing, as follows: 

PUBLIC SYMBOLS (Public Symbol Table) 

EXTERNAL SYMBOLS (External Symbol Table) 
USER SYMBOLS (User-Defined Symbol Table) 

The format of a symbol table output line is as follows: 

Columns Description 

1-6 Symbol names up to six characters, left-justified. 

7 Blank. 

8 Relocatabillty flag: absolute (A), relocatable CODE-segment (C), 
relocatable DATA-segment (D), external (E). 

9 Blank. 

10-13 Symbol value in hexadecimal. 

14-17 Blank. 

1&-n Repeat pattern of columns 1-17 for additional symbols, where "n" is the 

page width. 

Error Summary 

After listing the last line of the symbol table and spacing one line, the assembler lists 
an error summary line m the following format: 

Coiumns Description 

1-19 The string "ASSEMBLY COMPLETE" 

20-23 Number of errors. Four character positions containing the number of errors 

in the source encountered during assembly. This decimal number is right- 
justified and left biank-fiiied. If there are no errors, the string "NO" is out- 
put instead. 

24 Blank. 

2M0 The string "ERRORS" 

31 Blank. 

32 If the number of errors is not zero, the character "("; otherwise, blank. 

33-36 If the number of errors is not zero, these four character positk)ns contain 

the sequence number (in decimal) of the last source line with an error; 
otherwise, blank. 

37 If the number of errors is not zero, the character ")"; otherwise, blank. 
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Symbol-Cross-Reference Listing 

The assembler generates a file of symbol-cross-reference records during assembly 
pass 1 if the XREF assembler control is selected. This control is described in Chapter 
2. The actual symbol-cross-reference listing is generated by running the XREF utility 
program, using the ASXREF.TMP file created during pass 1 as input. The utility 
sorts symbols alphabetically before producing its listing. 



Page Header 

Columns Description 

1-40 The string "ISIS-li ASSEMBLER SYMBOL CROSS REFERENCE" 

41 Blank. 

42-45 The string "Vx.y" where "x" is the version and "y" is the release number. 

46-64 Blanks. 

65-68 The string "PAGE" 

69 Blank. 

70-72 Three character positions containing the page number in decimal. 

Cross-Ref erence Output Line 

Columns Description 

1-6 For lines that start a new entry, this field contains the symbol itself; 

otherwise, blank. 

7 Blank. 

8-11 Sequence number of source line containing a reference to or definition of 

the current symbol entry. 

12 Blank if the source line contains a reference; "#" if the source line contains 

a definition. 

13-14 Blanks. 

15-68 Repetitions of format in columns 1-14. 

If no errors are found during the symbol-cross-reference listing, the message 

CROSS REFERENCE COMPLETE 
is issued following the listing. If an error is found, the listing terminates immediately. 
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CHAPTER 5 
PL/M LINKAGE CONVENTIONS 



With the relocation feature, it is possible for an assembly language program module 
to call a procedure originally coded in PL/M. (PL/M procedures can also call 
assembly language modules.) 

Linkage between assembly language modules and PL/M procedures should follow 
the linkage conventions of PL/M. 

Formal parameters declared in a procedure definition are treated as locally-defined 
variables for the PL/M procedure. That is, each parameter is allocated storage se- 
quentially in memory as if it were a variable local to the procedure. During pro- 
cedure invocation, actual parameters are evaluated, and the results assigned to the 
corresponding formal parameters. Parameters are passed as follows: 

• A single BYTE parameter is passed in register C. A single ADDRESS parameter 
is passed in register B (high-order byte) and C Oow-order byte). 

• If there are two parameters, the first is passed as described above; the second is 
passed in registers D (high-order byte, if any) and E (low-order byte). 

• When there are more than two parameters, the last two are passed as described 
above, and the remainder are passed via the stack. 

All actual parameters are copied into the locations of the formal parameters upon 
entry to the procedure. 

CPU registers are used to hold results returned by procedures which have the BYTE 
or ADDRESS attribute. In the case of a BYTE procedure, the value is returned in 
the accumulator, while an ADDRESS procedure returns the low-order byte in the L 
register and the high-order byte in the H register. 



5-1 




CHAPTER 6 
RUNNING YOUR PROGRAM 



Absolute Programs 



If your program was assembled using the ASEG location counter, you may be able 
to load and test your program on the Intellec development system immediately after 
it is assembled. Notice, however, that your program must include an ORG directive 
that will cause the program to load into a memory location that will not conflict with 
ISIS-II. (ORG 4000H loads your program well above ISIS-II.) If your program does 
not include such an ORG directive, it must be reassembled before you attempt to 
execute it. 

To execute your program, you need only enter its object file name in response to an 
ISIS-II prompt. For example, assume that your program's name is MYPROG. By 
default, its object file name is MYPROG.OBJ. Entering MYPROG.OBJ after an 
ISIS-II prompt loads the program and starts its execution. 

Program execution begins at the address specified as the operand of the END direc- 
tive in the source program. If this address is missing or conflicts with ISIS-II, the 
program cannot be executed. 

Relocatable Programs 

Some portion of your program has been assembled in the relocatable mode if the 
program contains a CSEG or DSEG directive. Such programs are not directly exe- 
cutable since some addresses are assembled relative to zero rather than any actual 
address. To resolve these addresses, you must submit your object file to the 
LOCATE program. LOCATE supplies absolute addresses for the relocatable ad- 
dresses. Notice that you can supply absolute load addresses through the LOCATE 
program. These addresses override any ORG directives in your program. Also, you 
must be certain to locate your program so that is does not conflict with ISIS-Il. 

If your program comprises a number of separately assembled modules, you must 
submit the object file to the LINK program before using LOCATE. The LINK pro- 
gram binds together the separate modules and resolves any external addresses speci- 
fed by EXTRN directives. 

The final product of LINK (if needed) and LOCATE is an absolute object program 
file. You can run this program as though it were assembled as an absolute program. 
Program execution begins at the address specified as the operand of an END direc- 
tive in the source program. When the program comprises separately assembled 
modules, only one module may specify a start address in its END directive. If this 
address is missing or conflicts with ISIS-II, the program cannot be executed . 
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CHAPTER 7 
ERROR MESSAGES 



Error Detection and Reporting 

The assemblers detect and report three classes of errors: source-file errors (including 
control line errors), run-time errors, and assembler control syntax errors. 

Source-file errors are indicated in the assembly listing by single-letter codes listed in 
column 1 of the erroneous source statement. If multiple errors occur in the same 
statement, only the first error is reported. Each error is followed by a pointer to the 
previous erroneous line to ease finding errors. A summary of source-file errors is 
sent to the console and list devices. 

Run-time errors cause the assembly to terminate abnormally. An error message of 
the form: 

error type ERROR 

is sent to the console and list device (if listing is in progress) and control returns to 
ISIS-II. 

Assembler control errors in the assembler command are reported on the console 
device with the message: 

COMMAND ERROR 

ISIS-II errors are shown as numerical codes. These are listed at the end of this 
chapter and explained in more detail in the ISIS-II System User's Guide. 



Error Codes 

Source-File Errors 

Code Source 

B Balance error. Parentheses or q uote marks are u n balanced . 

C Control line error. An illegal control has been specified in a control line or a 

primary control appears in illegal context. The erroneous control and following 
controls on the same line are ignored. 

E Expression error. An expression has been constructed erroneously; usually a 

missing operator or delimiter. Also caused by adjacent operands with no 
separating operator. 

I Illegal character. A statement contains an invalid ASCII character, or a 

specified number is illegal in the context of the number base in which it oc- 
curs. Also issued if a carriage return character is not followed by a line-feed 
character. 

L Location counter error. The symbol being defined has been illegally forward 

referenced. The definition is made in all cases except macro definitions. This 
condition can be corrected by moving the definition to precede all references. 
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Code Source 

M Multiple definition. A symt>ol is illegally defined because of prior permanent 

definition. Only symbols defined by SET and MACRO are redefinable. All oc- 
currences of the multiply-defined item are flagged. 

N Nesting error. Conditional assembly statements of macro body delimiters are 

improperly nested. 

O Opcode or operand illegal. An opcode or operand illegal in this particular 

device's instruction set causes a warning. 

P Phase error. Value of symbol being defined has changed t>etween passes 1 

and 2 of assembly. Caused by a forward reference of an operand in an ORG, IF, 
or DS directive. 

Q Questionable syntax. Invalid syntax, usually due to a missing opcode. 

R NAME directive was preceded by an instruction or another directive. 

U Undefined symbol. Symbol used has not been defined. 

V Value illegal. Value exceeds permissible range for this operation or is null. 

X Illegal operand. Specified operand is illegal for this operation. Possible use of 

register-type symbol in illegal field or use of nonregister type in a field requir- 
ing register type. 



Run-Time Errors 
Message 
EOF ERROR 

FILE ERROR 

MEMORY ERROR 
STACK ERROR 



TABLE ERROR 



Explanation 

End-of-file has been encountered before END directive or 
END was not terminated by a carriage-return, line-feed. 

An ISIS file name used in an assembly-time command or 
control line is illegal or missing. Following this message. ISIS- 
11 will report its own enror number (see below). 

System has insufficient memory to execute assembler. 

Assembler internal stack has overflowed. Possible cause of 
error: 

1 . Operators nested more than 16 deep; 

2. More than 8 operands in DB or DW list; 

3. More than 128 characters in an operand field (probably 
string too long); 

4. Macro or conditional assembly nesting greater than 8 
deep. 

5. INCLUDES nested more than 4 deep. 

Assembler symbol or macro table has overflowed. More 
memory needed, or reduce number of symbols or macro 
definitions/calls. 
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Assembler Control Error 

Message Explanation 

CX)MMAND ERROR Assembler console command line syntax is illegal, usually 

due to missing or illegal delimiter or missing parameter. The 
entire command line is ignored. 



ISIS-II Error Messages 

By convention, error numbers 1-99 are reserved for errors that originate in or 
are detected by the resident routines of ISIS; error numbers 101-199 are reserv- 
ed for user programs; numbers 200-255 are used for errors encountered by 
nonresident system routines. In the following list an asterisk precedes fatal er- 
rors. The other errors are generally nonfatal unless they are issued by the 
CONSOLE system call. 



No error detected. 

* 1 Insufficient space in buffer area for a required buffer . 

2 AFTN does not specify an open file. 

3 Attempt to open more than six files simultaneously. 

4 Illegal filename specification. 

5 Illegal or umecognized device specification in filename . 

6 Attempt to write to a tile open for input. 

*1 Operation aborted; insufficient diskette space. 

8 Attempt to read from a file open for output. 

9 No more room in diskette directory. 

1 Filenames do not specify the same diskette. 

1 1 Cannot rename file; name already in use. 

1 2 Attempt to open a tile ahready open. 

13 No such file. 

14 Attempt to open for writing (output or update) or to delete or rename a 
write-protected file. 

* 1 5 Attempt to load into ISIS area or buffer area. 

* 16 Incorrect ISIS binary format. 

17 Attempt to rename or ddete a file not on diskette. 

1 8 Umecognized syston call. 

1 9 Attempt to seek in a file not on diskette. 

20 Attempt to seek backward past beginning of file. 

21 Attempt to rescan a file not line edited. 

22 Illegal ACCESS parameter to OPEN or access mode impossible for file 
specified (input mode for :LP:, for example). 

23 No filename specified for a diskette file. 

24 Input/ou^ut error on diskette (see below). 

25 Incorrect specification of echo file to OPEN. 

26 Incorrect SWID parameter in ATTRIB system call. 

27 Incorrect MODE parameter in SEEK system call. 

28 Null file extension. 

*29 End of file on console input. 

* 30 Drive not ready. 

3 1 Attempted seek on file open for output. 

32 Can*t delete an open file. 

33 Illegal system call parameter. 

34 Bad RETSW parameter to LOAD. 

35 Attempt to extend a file opened for input by seeking past end-of-file. 
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When error number 24 occurs, an additional message is output to the console: 

FDCC = 00nn 
where nn has the following meanings: 



01 


Deleted record. 


02 


CRC error (data field). 


03 


Invalid address mark. 


04 


Seek error. 


08 


Address error. 


OA CRC error (ID field). 


OE 


No address mark. 


OF 


Incorrect data address mark. 


10 


Data overrun or data underrun. 


20 


Write protect. 


40 


Write error. 


80 


Not ready. 
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